home *** CD-ROM | disk | FTP | other *** search
/ Just Call Me Internet / Just Call Me Internet.iso / prog / atari / c / blf082b / blouf.txt < prev    next >
Text File  |  1993-11-03  |  5KB  |  128 lines
  1. B l o u f G a t e                                            [BETA VERSION]
  2. -----------------------------------------------------------------------
  3. A Public Domain Fidonet/Usenet Gateway Software
  4. Originally written by Vincent Pomey & Franck Arnaud
  5.  
  6.  
  7. INTRO
  8.  
  9. BloufGate is a public domain buggy Fidonet/Usenet gateway software which 
  10. acts as an interface beetwen a Fidonet node producing packets to a point 
  11. system (the gateway). BloufGate converts these packets from the 
  12. Fidonet node to news and batchsmtp batches. It converts news batches 
  13. and incoming emails from the RFC setup to Fidonet packets imported by the 
  14. fidonet node's tosser.
  15.  
  16. It has the following features:
  17.  
  18. - Export/imports RFC1036 Newsbatches
  19. - Exports BATCHSMTP OR RFC822 email
  20. - Export/Imports Fidonet Type 2 packets (PKT)
  21. - Imports RFC822 mails
  22. - Bidirectional conversion of multiple part user names (replys to Jean.Pierre
  23.   Smith.Average are correct instead of the common Jean Pierre Smith Average)
  24. - Can use xx.fidonet.org for local mails of the nodes and pxx.fxxx.etc for
  25.   other systems (or optionally the second form for everything)
  26. - Optionally bounces messages too large (fido>rfc way)
  27. - Optionally adds Galactic headers :-)
  28. - Optionally does checking on Internet address before converting
  29. - (Limited) gating of moderated groups (that is it doesn't gate groups 
  30.   marked as moderated on the fido>usenet way, it is a feature)
  31. - Optionally bounces mails from unlisted fidonet nets, add net name in 
  32.   Organization: field. It uses a compiled list of nets (for space and 
  33.   convenience reasons), and is provided with a nodelist compiler. It may 
  34.   be easily extended to support any type of compiled nodelist.
  35. - Supports proposed ^RFCID: (fsc-0070) controls.
  36. - Supports protosed ^REPLYTO ^REPLYADDR (fsc-00??) controls.
  37.  
  38. No real documentation is provided, you'll have to read the commented 
  39. sample configuration, this intro document, the usage page of the program, 
  40. and ultimately the source code. If someone want to write a documentation 
  41. or remove all the english language mistake of the existing ones, s/he is 
  42. most welcome.
  43.  
  44.  
  45. LICENSE
  46.  
  47. The software is full public domain. Any part or all of the source code 
  48. can be copied, distributed, used and sold freely without any restriction.
  49.  
  50.  
  51. USAGE
  52.  
  53. Edit the blouf.cfg file to fit your system. A sample commented blouf.cfg
  54. is provided with this distribution.
  55.  
  56. blouf.cfg must be in the current directory or you should specify either 
  57. -c<config-file> on the command line    (example: "-c/usr/lib/fido/blouf.cfg")
  58. or a BLOUFRC environment variable.
  59.  
  60. The -d option on the command line displays the parsed config file.
  61.  
  62. The blouf program has the following syntax:
  63.  
  64. 1) Convert fidonet PacKeTs to RFC mails
  65. =======================================
  66.  
  67. blouf -fido <packet-file> ...
  68.  
  69. Input:  <packet-file>: Fidonet type 2 packet
  70. Output: Various files in rfc outbound directory ("outrfc" dir in blouf.cfg) 
  71.         <8-hex-digit>.rfc: RFC822 or BATCHSMTP email files  
  72.         <8-hex-digit>.nws: RFC1036 news batch, uncompressed
  73.  
  74. 2) Convert RFC mails to PKT
  75. ===========================
  76.  
  77. blouf -mail [-t<to-address>] <rfc-file> ...
  78.  
  79. Input:  <rfc-file>: RFC822 email file
  80.         <to-address>: optional envelope address, it otherwise uses the
  81.         header's To: field.    
  82. Output: <8digit>.pkt: Fidonet PKT in PKT outbound dir, should be your 
  83.         fidonet inbound directory. ("outpkt" dir in blouf.cfg)
  84. Note:   On UNIX/Sendmail systems, you can put "blouf -mail -t<to> <mail>"
  85.         as your mail agent for *.fidonet.org.
  86.  
  87. OR 
  88.  
  89. blouf -mbox    [-t<to-address>] <mailbox-file>
  90.  
  91. Input:  <mailbox-file>: a mailbox file is simply RFC822 email messages
  92.         destined for one user concatenated into a text file.
  93.         <to-address>: optional envelope address, it otherwise uses the
  94.         header's To: field.    
  95. Output: <8digit>.pkt: Fidonet PKT in PKT outbound dir, should be your 
  96.         fidonet inbound directory? ("outpkt" dir in blouf.cfg)
  97. Note:    This is mainly useful to process a mailbox on, eg, a KA9Q system
  98.  
  99. Examples:    blouf -mail this.rfc
  100.             blouf -mail -ttom.jennings@f23.n1.z1.fidonet.org mailtom.txt
  101.             blouf -mbox -tjoe.user joe.txt
  102.  
  103. 3) Convert News bacthes/single article files (uncompressed) to PKT
  104. ==================================================================
  105.  
  106. blouf -news <news-file>
  107.  
  108. Input:  <rfc-file>: RFC1036 news batch / single article file
  109. Output: <8digit>.pkt: Fidonet PKT in PKT outbound dir, should be your 
  110.         fidonet inbound directory? ("outpkt" dir in blouf.cfg)
  111. Note:    <news-file> typically produced by a program like SLURP on a NNTP 
  112.         system
  113.  
  114. 4) In all commands
  115. ==================
  116.  
  117. "blouf -d" displays the configuration (you can check your config file 
  118. has been correctly parsed).
  119.  
  120. WARNING: RFC mail/news is supposed to come from a unix system with 
  121. <lf> only as a line separator, if your package produces DOS newsbatches 
  122. with cr/lf, convert the files to lf! (ka9q is such a package)
  123.  
  124. Mixed mode are not supported. (don't mix -mail,-news,-fido).
  125.  
  126. Multiple files allowed, so such a thing as blouf -news /usr/lib/uucp/*.rfc
  127. with a wilcard expanding shell (unix-like) should work.
  128.